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OPINT:  FUNCTIONAL  DESCRIPTION 


1 . 0  INTRODUCTION 

1.1  Purpose  of  the  Functional  Description 

k 

This  functional  description  provides  a  technical  de¬ 
lineation  of  the  specific  functions  that  OPINT  must  perform. 
It  serves  as  a  formal  basis  for  mutual  understanding  between 
the  functional  designer  of  the  system  and  the  software 
development  personnel.  Together  with  the  OPINT  System  Spe¬ 
cification,  it  serves  as  the  basic  documentation  for  systems 

development  and  implementation.  ^ 

\ 

1.2  References 


1.2.1  Barclay,  Scott,  et  al.  Handbook  for  Decision 

Analysis.  Technical  Report  77-6-30.  McLean, 
Virginia:  Decisions  and  Designs,  Inc.,  September 

1977. 

1.2.2  Amey,  Dorothy  M. ;  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision- 
Aiding  Software:  OPINT  Users  Manual.  McLean , 
Virginia:  Decisions  and  Designs,  Inc.,  April 
1979. 

1.2.3  Amey,  Dorothy  M. ;  Feuerwerger,  Phillip  H. ; 

Gulick,  Roy  M.  Documentation  of  Decision- 
Aiding  Software:  OPINT  Systems  Specification. 
McLean,  Virginia:  Decisions  and  Designs,  Inc., 
April  1979. 


1.3  Terms  and  Abbreviations 


1.3.1  OPINT  -  OPINT,  the  name  of  the  system,  is  an 
abbreviation  for  Operations  and  Intelligence,  reflecting  the 
system's  major  area  of  applicability. 

1.3.2  Terms  -  Standard  mathematical  notations  and 
decision-analytic  terminology  are  used  throughout  this 
functional  description.  Decision-analytic  terms  are  defined 
when  they  are  first  encountered.  Reference  1.2.1  provides 
more  detail  on  decision  analysis,  should  it  be  desired. 


2.0  SYSTEM  SUMMARY 


2.1  System  Description 

OPINT  is  a  decision-analytic,  model-building  software 
system.  Its  general  purpose  is  to  aid  decision  makers  by 
providing  them  a  capability  to  construct,  store,  retrieve, 
exercise,  and  refine  decision-analytic  models  of  complex 
decision  problems  they  face. 

The  OPINT  decision  model  is  the  organizing  framework 
for  information  processing.  Decision  analysis  is  the  method¬ 
ological  tool  with  which  the  decision  maker  defines  and 
exercises  the  OPINT  model  to  evaluate  decision  alternatives 
pertaining  to  the  problem. 

The  overall  objective  of  OPINT  is  to  ensure  that  the 
ultimate  decision  choice  is  a  coherent  one:  a  choice  that 
is  consistent  with  the  decision  maker's  own  value  structure 
and  belief  about  the  likelihood  of  future  events  that  will 
affect  the  decision  outcome.  For  a  complete  description  of 
the  purpose  and  use  of  OPINT,  see  OPINT  Users  Manual, 
Reference  1.2.2. 

2.2  Design  Objectives 

The  system  is  designed  to  be  used  interactively  by  end 
users  who  are  relatively  unsophisticated  with  respect  to 
computer  technology.  Accordingly,  the  design  satisfies  two 
human-factors  objectives:  OPINT  is  a  menu-driven  system 
and  is  generally  forgiving  of  procedural  errors  by  the  user. 

In  addition,  to  facilitate  the  production  of  the  pro¬ 
gram  specification  and  coding  necessary  to  implement  OPINT 


3.0  DETAILED  CHARACTERISTICS 


The  fundamental  product  of  OPINT  is  the  decision  model. 
The  OPINT  system  enables  the  user  to  create,  store,  retrieve, 
exercise,  and  refine  decision  models  interactively. 

All  of  the  specific  functions  that  OPINT  performs  are 
related  to  the  OPINT  decision  model.  Therefore,  in  order  to 
establish  a  frame  of  reference  for  understanding  the  OPINT 
functions,  it  is  necessary  to  begin  with  a  detailed  descrip¬ 
tion  of  the  format,  inputs,  and  outputs  of  the  decision 
model.  A  description  of  the  specific  functions  that  OPINT 
performs  appears  in  Section  4.0. 

3. 1  Model  Description 

Each  decision  model  created  by  the  user  has  a  unique 
label,  and  each  is  constructed  by  using  the  same  generic 
format.  The  model  format  is  shown  graphically  in  Figure 
3-1.  The  format  always  consists  of  all  of  the  following 
elements  which,  when  completely  specified,  uniquely  define 
an  OPINT  decision  model. 

3.1.1  The  decision  -  A  short  label,  D,  defining  the 
decision  problem.  This  label  is  also  applied  to  the  decision 
model  and  is  used  to  store  and  retrieve  the  model. 

3.1.2  Decision  alternatives  -  A  list  of  the  n  decision 

alternatives  (D^,  ,  ...  Dn)  available  to  the  decision 

maker.  Each  alternative  is  appropriately  labeled. 

3.1.3  An  uncertain  future  event  -  A  key  uncertain 
event,  E,  appropriately  lab*  ed,  that  will  influence  the 
eventual  outcome  of  d-  ision.  The  uncertain  event 
is  attached  to  each  of  the  decision  alternatives. 


DECISION 

ALTERNATIVES 


KEY 

UNCERTAIN 

EVENT 


EVENT 

OUTCOMES 


DECISION 

OUTCOMES 


Figure  3-1 

DECISION  MODEL  FORMAT 


3.1.4  Event  outcomes  -  A  list  of  the  m  discrete  event 


outcomes  (E^  E2,  ...  Em)  ,  each  appropriately  labeled,  that 
together  define  the  universe  of  possibilities  regarding  the 
occurrence  of  the  future  event. 

3.1.5  Event  probabilities  -  A  vector  of  m  probabili¬ 
ties  (p, ,  p_,  ...  p  )  that  are  associated  with  the  m  event 
outcomes,  such  that  pi  represents  the  probability  that  event 
E.  will  occur.  A  probability  is  a  measure  of  uncertainty. 

It  is  a  number  between  0  and  1,  inclusive,  that  represents 
the  extent  to  which  an  individual  believes  a  future  event 
will  occur.  However,  in  this  specification,  probabilities 
are  usually  expressed  as  a  percentage  of  certainty,  e.g.  ,  as 
40%  vice  0.4. 


3.1.6  Decision  outcomes  -  The  elements  discussed  thus 
far  define  n  x  m  possible  decision  outcomes.  Each  decision 
outcome  (D^ ,  E^)  is  a  paired  combination  of  one  decision 
alternative  with  one  event  outcome. 

The  remaining  three  elements  of  the  model  format 
are  used  to  specify  the  relative  consequences  associated 
with  the  decision  outcomes.  The  consequence  of  an  outcome 
is  expressed  in  terms  of  the  relative  regret  that  would  be 
experienced  by  the  decision  maker  should  the  outcome  actually 
occur. 


3.1.7  Decision  outcome  criteria  -  A  list  of  q  criteria 

( C. ,  C2,  ...  C  ),  each  appropriately  labeled,  by  which  the 
—  —  ^3 

decision  maker  would  judge  the  relative  regret  associated 
with  the  decision  outcome. 

3.1.8  Criteria  weights  -  A  vector  of  q  weights  (w^, 
w2,  ...  w^)  associated  with  the  q  criteria,  such  that  w^ 
represents  the  relative  contribution  of  criterion  C^. 
Criteria  weights  are  expressed  numerically  as  a  percentage 
of  the  whole,  e.g.,  as  60%. 


7 


3.1.9  Regret  -  Regret  is  a  measure  of  the  consequence 

of  a  decision  outcome.  The  total  regret  assigned  to  a 

decision  outcome  is  a  weighted  linear  combination  of  the 

individual  criteria  regrets.  For  each  criterion  (C^)  and 

for  each  decision  outcome  {D.,  E.  ),  the  user  must  specify  a 

3  K 


value  of  regret  (r^k) • 


A  regret  is  a  number  between 
0  and  -1,  inclusive,  that  represents  the  relative  degree  of 
dissatisfaction  that  the  decision  maker  associates  with  a 
particular  decision  outcome.  Zero  represents  no  regret;  -1 
represents  maximum  regret.  However,  in  this  specification 
regrets  are  usually  expressed  as  a  percentage  of  the  maximum; 
e.g.,  as  -30  vice  -0.3.  Refer  to  Figure  3-2. 


This  completes  the  model  format.  The  decision 
model  is  completely  and  uniquely  specified  when  the  elements 
described  above  are  defined  by  the  user. 


3.2  Results  of  the  Model 


The  input  specifications  describing  the  model  can  be 
processed  to  produce  the  following  results. 

3.2.1  Combined  value  regret  matrix  -  A  single  n  x  m 
matrix  that  displays  the  total  or  combined  regret  associated 
with  each  of  the  decision  outcomes.  For  each  outcome  (D., 
E^) ,  the  combined  regret,  r^,  is  obtained  by  weighting  and 
adding  the  component  regrets  contributed  by  the  q  criteria, 
in  accordance  with  the  following  formula: 


rjk 


-  E  -i 

i=l 


rijk. 


A  combined  value  regret  matrix  is  shown  in 


Figure  3-3 


Figure  3-3 

A  COMBINED  VALUE  REGRET  MATRIX 


3.2.2  Expected  value  matrix  -  A  single  n  x  m  matrix 
that  displays  the  weighted  expected  regret,  r^*  associated 
with  each  decision  outcome  (Dj,  E^)  .  The  expected  value 
matrix  takes  into  account  the  relative  likelihoods  of  the 
event  outcomes.  It  is  obtained  from  the  combined  value 
regret  matrix  in  accordance  with  the  following  formula: 

*jk  =  ?k  *jk. 

3.2.3  Expected  value  vector  -  A  vector  of  length  n 
that  displays  the  weighted  expected  regret,  R ^ ,  associated 
with  each  of  the  n  decision  alternatives  (D ^ ) .  The  expected 
value  vector  is  obtained  from  the  expected  value  matrix  in 
accordance  with  the  following  formula: 

m 

Rj  *  Ti 

k=l 

The  expected  value  matrix  and  the  expected  value 
vector  (total)  are  displayed  together,  as  shown  in  Fig¬ 
ure  3-4. 


3.3  Sensitivity  Analyses 


There  are  two  sensitivity  analyses  that  are  useful  to 
the  user.  Both  are  based  on  the  expected  value  vector  and 
are  described  as  follows: 


3.3.1  Threshold  matrix  -  An  n  x  11  matrix  that  dis¬ 
plays  the  eleven  expected  value  vectors  generated  by  either 
one  of  the  following  operations,  at  the  user's  option: 
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Figure  3-4 

AN  EXPECTED  VALUE  MATRIX  Atfo  AN  EXPECTED  VALUE  VECTOR 


Varying  the  probability  of  a  designated  event 
outcome,  E^ ,  from  0  to  100%,  in  steps  of  10. 
The  other  event  outcomes,  E ^ ,  maintain  their 
proportional  relationships  with  each  other. 


That  is, 

0j  =  P-,  (100  ~  Gj) 

100  -  p. 

where 

0^  *  a  variable,  the  test  probability 
of  E^ ,  varied  from  0  to  100%  in 
steps  of  10; 

0^  *  a  variable,  the  test  probability 
of  Ej  as  0^  is  varied; 

PA  *  a  constant,  the  originally  specified 
probability  of  event  E^; 

Pj  =  a  constant,  the  originally  specified 
probability  of  event  E ^ . 

Varying  the  weight  of  a  designated  criterion 
(C^)  from  0  to  100%,  in  steps  of  10.  The 
weights  of  the  other  criteria  (C ^ )  maintain 
their  proportional  relationship  with  each 
other  in  the  same  manner  as  do  the  probabili¬ 
ties  described  in  the  preceding  paragraph. 


That  is 


where 

w^,  Wj  =  constants — the  original  criteria 
weights; 

Wi'  Wj  *  variables — the  test  criteria 
weights. 

In  both  of  the  above  cases,  the  least  regret  displayed  in 
the  expected  value  payoff  vector  is  identified  by  an  asterisk. 

Normally,  the  decision  alternative  that  leads  to 
the  decision  outcome  having  the  least  regret  will  change  as 
the  designated  event  probability  or  criterion  weight  is 
incremented  from  0  to  100%.  The  points  of  change  are  referred 
to  as  threshold  points  and  are  noted  on  the  matrix.  Figure 
3-5  shows  an  example  threshold  matrix. 

3.3.2  Manually  change  event  probabilities  -  The  user 
may  generate  a  test  expected  value  vector  that  is  based  on 
an  arbitrarily  assigned  vector  of  event  probabilities.  The 
user  may  specify  several  different  probability  vectors  and 
note  the  resultant  expected  value  vectors.  An  example  of 
the  display  is  shown  in  Figure  3-6. 

3.4  Reference  Gamble 

A  reference  gamble  is  a  technique  designed  to  assist 
the  user  in  validating  the  specified  regret  values,  r^^* 

The  technique  addresses  the  single  vector  of  regrets  asso¬ 
ciated  with  one  designated  criterion,  C^,  and  one  designated 
event  outcome,  E^.  Specifically,  it  assists  the  user  by 
focusing  on  the  values  of  regret  assigned  to  the  n  decision 
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Figure  3-5 
A  THRESHOLD  MATRIX 
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Figure  3-6 

MANUALLY  CHANGED  EVENT  PROBABILITIES 


outcomes  resulting  from  the  various  decision  alternatives, 

D j ,  as  they  combine  with  the  fixed  criterion  (C^)  and  the 
fixed  event  outcome  (E^) . 

The  technique  assumes  that  the  greatest  regret  (rmax) 

and  the  least  regret  (r  .  )  in  the  vector  have  been  correctly 

min 

specified  by  the  user.  Accordingly,  the  technique  addresses 

only  the  intermediate  values  of  regret,  that  is,  those  that 

fall  between  r  and  r  .  . 

max  min 

For  each  decision  outcome  of  interest  (D.,  E.) ,  the 

J  K 

system  asks  the  user  to  respond  to  the  following  question: 


Would  the  user  prefer: 

i.  a  binary  gamble  in  which  the  best  outcome  (r  .  ) 

min 

would  occur  with  probability  P  and  the  worst  with 
probability  (100%  -  P) ,  or 

5.  obtaining  the  decision  outcome  of  interest  (D. ,  E.  ) 

J  K 

for  certain? 


The  system  sets  the  value  of  P  to  100%  initially,  so 
that  a  rational  user  would  certainly  prefer  the  first  option, 
the  gamble,  to  obtaining  the  intermediate  outcome  of  interest 
with  certainty.  However,  as  the  value  of  P  is  decremented 
in  steps  of  10%,  the  user  will,  at  some  point,  prefer  the 
second  option  to  the  reference  gamble.  At  the  point  of 
indifference  between  the  two  options,  the  user  has  established 
a  coherent  value  of  regret  for  the  decision  outcome  of 
interest.  That  regret  is  equal  to  the  expected  value  of  the 
reference  gamble ,  or : 
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User  responses 


WOULD  YOU  PREFER  TO  HAVE  CHOSEN 
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Figure1  3-7 

A  REFERENCE  GAMBLE  ELICITATION 


4.0  OPINT  FUNCTIONS 


OPINT  is  designed  to  perforin  the  basic  functions  de¬ 
scribed  below.  A  description  of  the  detailed  logical  design 
of  the  OPINT  functions  is  contained  in  the  manual.  Documenta¬ 
tion  of  Decision- Aiding  Software:  OPINT  System  Specification, 
Reference  1.2.3. 

4. 1  Maintain  a  Library  of  OPINT  Models 

Store  various  decision  models,  filed  by  their  associated 
labels. 

4. 2  Load  an  Existing  OPINT  Model 

Display  the  labels  of  those  models  stored  in  the  model 
library,  and  permit  the  user  to  retrieve  any  desired  model. 

The  loaded  model  is  referred  to  as  the  current  model. 

4.3  Display  the  Results  of  the  Current  Model 

Permit  the  user  to  examine  the  structure  and  content  of 
the  current  model  by  displaying: 

a.  event  probabilities, 

b.  criteria  weights, 

c.  regrets, 

d.  combined  value  regret  matrix, 

e.  expected  value  matrix,  and 

f.  expected  value  vector. 

4.4  Revise  the  Current  Model 


Permit  the  user  to  make  changes  to  the  structure  and 
content  of  the  current  model.  The  user  may  revise: 
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a.  event  probabilities, 

b.  criteria  and  criteria  weights, 

c.  decision  alternatives, 

d.  regrets, 

e.  combined  value  regret  matrix. 

4.5  Save  the  Current  Model 


Permit  the  user  to  add  the  current  model  to  the  model 
library. 

4. 6  Perform  Sensitivity  Analyses 

Permit  the  user  to  test  the  sensitivity  of  the  current 
model  by: 

a.  determining  thresholds, 

b.  manually  changing  probabilities. 

4.7  Create  a  New  OPINT  Model 


|  Permit  the  user  to  create  a  new  model,  which  then 

becomes  the  current  model.  The  user  creates  a  model  by 
specifying  the  elements  listed  in  Section  3.1.  The  user  may 
also  use  a  reference  gamble  to  validate  the  assigned  values 
*"  of  regret. 

i 
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